home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / xpaint-2.1.1 / Help.txt < prev    next >
Encoding:
Text File  |  1995-05-03  |  26.0 KB  |  843 lines
  1. #BEGIN introduction "Introduction"
  2. Welcome to the latest version of XPaint.
  3.  
  4. XPaint is a color image editing tool which features most standard paint
  5. program options.
  6. It allows for the editing of multiple images simultaneously and supports
  7. various formats, including PPM, XBM, TIFF, etc.
  8.  
  9. The functionality of XPaint is divided into a toolbox area for selecting
  10. the current paint operation and paint windows for modifying/creating
  11. images.  Each paint window has access to its own color palette and set
  12. of patterns, although the paint operation in use is globally selected
  13. for all windows.
  14.  
  15. XPaint runs on a variety of displays.  Saving
  16. images will adapt them to the current display type (i.e. a color image 
  17. loaded on a greyscale screen will be saved as a grey image).
  18.  
  19. More information is available under the specific topics.  Enjoy!
  20.  
  21. #BEGIN command    "Command Line Options"
  22. xpaint    [-popped][-size WIDTHxHEIGTH][-rcFile FILE][-12][-24][<files>...]
  23. #NL
  24.     -size    default width and height for new images
  25. #NL
  26.     -12        use a 12 bit PseudoColor visual
  27. #NL
  28.     -24        use a 24 bit TrueColor visual
  29. #NL
  30.     -popped        popup an empty canvas on startup
  31. #NL
  32.     -rcFile        use file instead of default .XPaintrc        
  33. #NL
  34.     <files>    image filenames to open
  35. #NL
  36. #BEGIN toolbox "Toolbox"
  37. The toolbox is used to set those options which are applicable to all
  38. XPaint canvases.
  39. #PUSH
  40. #BEGIN tool_file "File Menu"
  41. The file menu is used to create a new canvas or load an image from a file.
  42.  
  43. New Canvas
  44. #NL
  45.     Create a new blank canvas (default size:
  46. #NL
  47.     640x480).  See "Command Line Options" for
  48. #NL
  49.     changing the default size.
  50.  
  51. New with Size...
  52. #NL
  53.     Create a new canvas with the specified
  54. #NL
  55.     dimensions.
  56.  
  57. Open...
  58. #NL
  59.     Open an image file for painting.  Images can
  60. #NL
  61.     be opened in a variety of formats.  If none
  62. #NL
  63.     of the specific formats is selected, XPaint
  64. #NL
  65.     will attempt to perform a "Best Guess" as to
  66. #NL
  67.     the image format.  Unknown formats will result
  68. #NL
  69.     in an error message.
  70.  
  71. Load Clipboard...
  72. #NL
  73.     Open an image file into the XPaint clipboard
  74. #NL
  75.     for pasting.  Images which have been saved in
  76. #NL
  77.     a format supporting odd-shaped regions will be
  78. #NL
  79.     loaded as they were selected, otherwise all
  80. #NL
  81.     images are rectangular.  See "Paste" and
  82. #NL
  83.     "Save Region..." under the Edit and File menus
  84. #NL
  85.     of the Painting Window for more information.
  86.  
  87. Quit
  88. #NL
  89.     Exit XPaint, closing all windows.
  90. #BEGIN tool_line "Line Menu"
  91. The line menu sets the value of the line width.  This value is used by all
  92. operations which paint any type of line, including the borders of boxes,
  93. ovals and polygons.
  94. #BEGIN tool_font "Font Menu"
  95. This menu selects the current font to use for the text operation.  There are
  96. a few specific fonts choices listed, but all fonts are available through
  97. the font browser.
  98.  
  99. Note:  Changing a font while inserting will not allow backspacing over text
  100. in a previous font.
  101.  
  102. See "Font Browser" for more information on its use.
  103. #PUSH
  104. #BEGIN font_browser "Font Browser"
  105. The font browser is designed to allow any available font to be used for
  106. painting with the text operation.  A font is selected by choosing an item
  107. from each of the given lists until the font is displayed in the "selection"
  108. area.  As items are selected, all lists will adjust to reflect existing
  109. fonts with the selected characteristics.  Clicking in the blank area
  110. of a item list will reset that list to all available options (i.e. unselect
  111. the current one).
  112.  
  113. If the X server supports variable sized fonts, the point size list will
  114. contain a "0" entry, which will use the value specified in the
  115. "Point Size" field.
  116.  
  117. #POP
  118. #BEGIN tools "Painting Tools"
  119. The painting tool icons set the current painting operation for all canvases.
  120.  
  121. Operations are selected with mouse button one.  Pressing mouse button three
  122. while over any of the icons will bring up a menu of options available for
  123. that tool.  Some icons also allow double-clicking as a faster method of
  124. bringing up style options.
  125.  
  126. See the specific paint operation for more information.
  127. #PUSH
  128. #BEGIN arc "Arc"
  129. The arc operation paints an arc between two selected points in the primary
  130. color/pattern, using the current line width.  Arcs are generally a
  131. quarter of an ellipse, but may be restricted to a circular shape by
  132. pressing the shift key while painting.
  133.  
  134. See "Line Menu" under the toolbox for more information about line width.
  135. #BEGIN box "Boxes"
  136. The box operations paint either rectangles or squares using the current line
  137. width. Pressing shift while moving the mouse after selecting the first point
  138. will constrain the box to a square.
  139.  
  140. Squares can also be painted by selecting the 'center' option from the menu
  141. found by pressing button three on the icon.  This will define the first point
  142. as the center of the square with the second point being on the perimeter.
  143.  
  144. Filled boxes are painted in the primary color/pattern and filled
  145. with the secondary color/pattern for the canvas.
  146.  
  147. See "Line Menu" under the toolbox for more information about line width.
  148. #BEGIN brush "Brush"
  149. The brush operation uses the current brush to paint on the canvas(es).
  150. Painting is accomplished by holding down the mouse button and
  151. moving the mouse in the canvas area.  Button one paints in the selected primary
  152. color/pattern, while button two uses the secondary one.
  153.  
  154. The current brush style may be changed through the brush chooser available
  155. on the button three menu for either the brush or erase operation icons.
  156. #BEGIN cline "Connected Line"
  157. The connected line operation paints a series of straight lines connected at
  158. selected vertices.  Each new vertex is selected using the first mouse button.
  159. The second mouse button ends this operation, without forming a new vertex.
  160.  
  161. All painting is done in the primary color/pattern using the currently defined
  162. line width.
  163.  
  164. See "Line Menu" under the toolbox for more information about line width.
  165. #BEGIN dotPencil "Dot Pencil"
  166. The dot pencil operation paints a series of dots on the canvas, following the
  167. cursor while the mouse button is pressed.
  168.  
  169. Button one paints in the primary color/pattern, button two the secondary
  170. color/pattern.
  171.  
  172. See "Pencil" for painting connected lines.
  173. #BEGIN erase "Erase"
  174. The erase operation is designed to either erase a section of the painting to
  175. the set background color for the canvas or to revert the erased area to
  176. the originally loaded image.  (Note:  This is not the last saved image!)
  177.  
  178. The eraser is the style of the current brush, and the brush selection
  179. window is accessible through the menu found by clicking mouse button
  180. three on either the erase or brush icons.
  181.  
  182. See help on the "Brush" or on "Change Background..." under the Image menu of
  183. the Painting Window for more information.
  184. #BEGIN fill "Fill"
  185. The fill operation will paint an area around a selected pixel the current
  186. primary or secondary color/pattern (based on which mouse button used).  The
  187. area is determined by matching adjacent pixel values until a variation is
  188. found.  Diagonal pixels are not considered adjacent.
  189. #BEGIN line "Line"
  190. The line operation paints a straight line in the primary color/pattern
  191. between two selected points on the canvas, using the global line width.
  192.  
  193. See "Line Menu" under the toolbox for more information about line width.
  194.  
  195. Lines may also be restricted to increments of 45 degrees (i.e.
  196. horizontal, vertical, or diagonal) by pressing down the shift key while
  197. painting.
  198. #BEGIN oval "Ovals"
  199. The oval operations paint either circles or ovals using the current line width.
  200. Ovals/circles are painted by selecting two points which inherently define
  201. a box around the area for the oval.  Pressing shift while moving the mouse will
  202. constrain the oval to a circle.
  203.  
  204. Circles can also be painted by selecting the 'center' option from the menu
  205. found by pressing button three on the icon.  This will define the first point
  206. as the center of the circle with the second point being the radius.
  207.  
  208. Filled ovals and circles are painted in the primary color/pattern and filled
  209. with the secondary color/pattern for the canvas.
  210.  
  211. See "Line Menu" under the toolbox for more information about line width.
  212. #BEGIN pencil "Pencil"
  213. The pencil operation paints a connected line on the canvas, following the
  214. cursor while the mouse button is pressed.  The global line width is used
  215. to determine the width of this line.
  216.  
  217. Button one paints in the primary color/pattern, button two the secondary
  218. color/pattern.
  219.  
  220. See "Line Menu" under the toolbox for more information about line width.
  221. #BEGIN poly "Polygons"
  222. Polygon operations paint polygons as defined by a series of straight lines
  223. between selected vertices.  Each new vertex is selected using the first mouse
  224. button.  Ending this operation (done through pressing the second mouse
  225. button) does not create a new vertex and results in the last created
  226. vertex being joined to the first.
  227.  
  228. All painting is done in the primary color/pattern using the currently defined
  229. line width.  Filled polygons are filled in the secondary color/pattern.
  230.  
  231. See "Line Menu" under the toolbox for more information about line width.
  232. #BEGIN ray "Ray"
  233. The ray operation paints rays from the first selected point to all
  234. subsequent points in the primary color/pattern.  Button two ends this
  235. operation without selecting a new ray point.  Rays may also be restricted
  236. to slopes based on a 45 degree increment (i.e. horizontal, vertical,
  237. or diagonals) by pressing the shift key while painting.
  238.  
  239. The width of the rays is determined by the global value for the line
  240. width, set via the "Line" menu.
  241.  
  242. See "Line Menu" under the toolbox for more information about line width.
  243. #BEGIN select "Select Regions"
  244. There are two operations for selecting regions:  Select Box and Select Area.
  245. "Select Box" will select a rectangular or square region (holding down
  246. shift while pressing the mouse button with constrain the region to a
  247. square).  "Select Area" selects an arbitrary region.  The three possible
  248. modes used by these operations are set by the options on the button three
  249. menu for either icon:
  250.  
  251. All Colors             Select the entire region.
  252. #NL
  253. Omit Color Range    Select the region, excluding the
  254. #NL
  255.                 specified range of colors.
  256. #NL
  257. Only Color Range    Select only the specified color range
  258. #NL
  259.                 in the region.
  260. #NL
  261. Select Range...        Brings up a window to select the
  262. #NL
  263.                 range of colors for these operations.
  264.  
  265. See "Range Selection" for more information on choosing a range of colors
  266. for these operations.
  267.  
  268. Operations which may be performed on selected regions include the ability
  269. to move and resize them.  Holding shift down during resizing will constrain
  270. the region to its original aspect ratio.  Note that moving a region will
  271. result in the original location being painted in the current background
  272. color.
  273.  
  274. See "Background Color..." under the Image menu of the Paint Window for
  275. more information.
  276. #PUSH
  277. #BEGIN range_select "Range Selection"
  278. This window is designed for selecting a range of colors for use with
  279. the select region operations.  The color range is determined by setting a
  280. base color and the amount of variance in each of the RGB values around
  281. this color.  Colors are considered in this range if they match a value based
  282. on the base color +/- the given variance.   Default base color is white.
  283.  
  284. The "Pixel Delta" button allows the user to choose another color which will
  285. be used to calculate the variance from the base color.
  286.  
  287. More information on colors and the use of the color wheel may be found
  288. under the "Pattern Editor on the "Painting Window".
  289. #POP
  290. #BEGIN blob "Shape"
  291. Shape operations allow the user to draw closed objects with a 
  292. pencil-like operation.  When the mouse button is released, the last drawn 
  293. point is connected to the starting point. 
  294.  
  295. Painting can either be done in the primary color/pattern with button one or
  296. in the secondary color/pattern with button two.  Filled shapes are filled in
  297. the other palette color/pattern.  Border width is determined by the current
  298. setting for line width.
  299.  
  300. See "Line Menu" under the toolbox for more information about line width.
  301. #BEGIN spray "Spray"
  302. The spray operation is designed to emulate a spray can.  It will paint
  303. a random set of dots withing a given radius.
  304.  
  305. It is possible to change the attributes of the spray operation to
  306. achieve the desired effect.   There are three parameters which will
  307. modify the configuration of the spray tool:
  308. #NL
  309.     radius    how large of a circle to fill
  310. #NL
  311.     density    number of dots in the given area
  312. #NL
  313.     rate        speed to fill the area in tenths of a second
  314.  
  315. Additionally, it is possible to change the distribution of the dots to
  316. be either even or gaussian (usually only noticeable at large radii).
  317. These options are found in the menu brought up by clicking button three
  318. on the spray icon.
  319.  
  320. As with many other operations, the spray operation can make use of either
  321. the primary or secondary color/pattern based on which button (one or two,
  322. respectively) is held down while painting on the canvas.
  323. #BEGIN text "Text"
  324. The text operation allows for typing in the currently selected font.
  325. Pressing mouse button two in the canvas area while inserting text
  326. will paste text from the X clipboard at the current insertion point.
  327.  
  328. See the "Font Menu" for information on changing the selected font.
  329.  
  330. Note:  Changing a font while inserting will not allow backspacing over text
  331. in a previous font.
  332. #POP
  333. #POP
  334. #BEGIN canvas "Painting Window"
  335. The painting window holds a canvas area for painting the displayed image,
  336. menus for performing operations on this image, and primary and secondary
  337. color/pattern palettes along with buttons for adding to these.
  338.  
  339. Painting on the image is accomplished by selecting a operation from
  340. the global toolbox and applying it in the canvas area.  See help on the
  341. specific paint operation for its use.
  342.  
  343. #PUSH
  344. #BEGIN fileMenu "File Menu"
  345. The file menu on the painting window is for saving information associated
  346. with the image displayed on the current paint canvas. 
  347.  
  348. XPaint runs on a variety of displays.  Saving
  349. images will adapt them to the current display type (i.e. a color image 
  350. loaded on a greyscale screen will be saved as a grey image).
  351.  
  352. See "Image Formats" for a description of the image formats usable
  353. by XPaint.
  354.  
  355. Save
  356. #NL
  357.     Save the current image with the original
  358. #NL
  359.     filename and format.  If this is a new
  360. #NL
  361.     image, perform the "Save As" operation.
  362.  
  363. Save As
  364. #NL
  365.     Save the current image with the specified
  366. #NL
  367.     filename and format (default is TIFF).
  368.  
  369. Save Region...
  370. #NL
  371.     Save the selected region, in the original
  372. #NL
  373.     form that it was selected (width, height and
  374. #NL
  375.     rotation).  Odd-shaped regions will be saved
  376. #NL
  377.     as rectangles filled with the background
  378. #NL
  379.     color.  If the output format supports image
  380. #NL
  381.     masks (e.g. TIFF, XPM), then this
  382. #NL
  383.     information will also be saved.  See "Load
  384. #NL
  385.     Clipboard..." under the toolbox file menu
  386. #NL
  387.     for more information about odd-shaped
  388. #NL
  389.     images.
  390.  
  391. Save Palette...
  392. #NL
  393.     Save the current palette. See "Palette
  394. #NL
  395.     Area" for more information on how
  396. #NL
  397.     patterns are loaded.
  398.  
  399. Close
  400. #NL
  401.     Close the current painting window, saving
  402. #NL
  403.     the image if desired.
  404.  
  405. #BEGIN editMenu "Edit Menu"
  406. The edit menu provides for a set of operations which interact with the
  407. current selection and the paint clipboard.  This menu is also accessible
  408. through button three on the painting canvas.  The clipboard is an off-screen
  409. image which is loaded either from a selected region via these operations
  410. or from a file.
  411.  
  412. See "Load Clipboard..." on the toolbox "File Menu" for more information
  413. about loading images from a file and "Change Background..." under the
  414. "Image Menu" for more information on the background color.
  415.  
  416. Undo
  417. #NL
  418.     Reverse the last performed operation (with
  419. #NL
  420.     the exception of the region operations).
  421.  
  422. Cut
  423. #NL
  424.     Load the originally selected region into
  425. #NL
  426.     both the XPaint and X server clipboards and
  427. #NL
  428.     change the area on the screen to the
  429. #NL
  430.     background color.
  431.  
  432. Copy
  433. #NL
  434.     Load the originally selected region into the
  435. #NL
  436.     XPaint and X server clipboards.
  437.  
  438. Paste
  439. #NL
  440.     Place the image in the clipboard onto the
  441. #NL
  442.     canvas at the last position where button one
  443. #NL
  444.     or two was pressed.  Images are first
  445. #NL
  446.     searched for in the X server clipboard and
  447. #NL
  448.     then the internal XPaint clipboard.
  449.  
  450. Clear
  451. #NL
  452.     Remove the current selection from the paint    
  453. #NL
  454.     canvas.
  455.  
  456. Duplicate
  457. #NL
  458.     Perform both the copy and paste operations in one.
  459.     
  460. Select All
  461. #NL
  462.     Select the entire image on the canvas.
  463. #NL
  464.     (Note:  This does not use the color range
  465. #NL
  466.     options which the select area operators from
  467. #NL
  468.     the toolbox do!)
  469.     
  470.  
  471. #BEGIN regionMenu "Region Menu"
  472. This menu provides operations which can be applied to the currently
  473. selected region.  See the "Select Regions" item under the toolbox
  474. Painting tools for information on how to select regions.
  475.  
  476. Note:  The 'undo' operation found under the Edit menu does not work
  477. on these operations!
  478.  
  479. Flip X Axis
  480. #NL
  481.     Flip the current region horizontally.
  482.  
  483. Flip Y Axis
  484. #NL
  485.     Flip the current region vertically.
  486.  
  487. Rotate By
  488. #NL
  489. Rotate...
  490. #NL
  491.     Both of these operations allow for rotating
  492. #NL
  493.     the current image by a specified number of
  494. #NL
  495.     degrees.  Rotation may also be done
  496. #NL
  497.     by pressing button two on the
  498. #NL
  499.     selection.
  500.  
  501. Invert
  502. #NL
  503.     Inverts the colors of the selected region
  504. #NL
  505.     (e.g. black to white).
  506.  
  507. Sharpen
  508. #NL
  509.     Applies an image processing algorithm in an
  510. #NL
  511.     attempt to increase the detail on the
  512. #NL
  513.     selected region.  This operation is not
  514. #NL
  515.     reversible.
  516.  
  517. Smooth
  518. #NL
  519.     Attempts to blend the colors of the region
  520. #NL
  521.     by averaging the pixel's color values with
  522. #NL
  523.     those of its neighbors.  This operation is
  524. #NL
  525.     not reversible.
  526.  
  527. Edge Detect
  528. #NL
  529.     Performs an image processing edge
  530. #NL
  531.     detection.  Not reversible and ugly.
  532.  
  533. Emboss
  534. #NL
  535.     Converts the selected region to a grey image
  536. #NL
  537.     which is highlighted such that the details
  538. #NL
  539.     appear to stand out from the screen.
  540.  
  541. Reset
  542. #NL
  543.     Return the current image to its original
  544. #NL
  545.     size and orientation.  Note:  None of the
  546. #NL
  547.     image processing operations will be undone.
  548.     
  549. #BEGIN imageMenu  "Image Menu"
  550. The image menu provides a set of operations which are applied to
  551. the current image/paint canvas. 
  552.  
  553. Fat Bits
  554. #NL
  555.     Brings up the Fat Bits editor which allows
  556. #NL
  557.     for editing an enlarged area of the current
  558. #NL
  559.     image without having to enlarge the entire
  560. #NL
  561.     image.
  562.  
  563. Visible Grid
  564. #NL
  565.     Turns on and off a visible black grid
  566. #NL
  567.     between the original pixels on images with a
  568. #NL
  569.     scale greater than 1 (i.e. zoomed).  This
  570. #NL
  571.     grid is only for painting purposes.  It does
  572. #NL
  573.     not affect the actual image.
  574.  
  575. Snap
  576. #NL
  577.     Turns on/off restriction of the current x
  578. #NL
  579.     and y position for most operations to an
  580. #NL
  581.     invisible grid.
  582.  
  583. Snap Spacing...
  584. #NL
  585.     Sets the distance between points on the
  586. #NL
  587.     invisible snap grid.
  588.  
  589. Change Background...
  590. #NL
  591.     This operation changes the background color
  592. #NL
  593.     for the current image (default color is
  594. #NL
  595.     white).  This is only used when a region is
  596. #NL
  597.     erased or cut from the current image and
  598. #NL
  599.     when odd-shaped regions are saved. See
  600. #NL
  601.     "Color Wheel" under the "Pattern Editor" for
  602. #NL
  603.     more information on selecting a color.
  604.  
  605. Change Size...
  606. #NL
  607.     Changes the size of the current canvas by
  608. #NL
  609.     cutting away or adding area on the right and
  610. #NL
  611.     lower sides.  This operation is not
  612. #NL
  613.     reversible and affects the actual image
  614. #NL
  615.     size.
  616.  
  617. Change Zoom...
  618. #NL
  619.     Enlarges the working image by the specified
  620. #NL
  621.     scale.  This does not affect the size of the
  622. #NL
  623.     image for saving, etc.
  624.     
  625. #BEGIN patBox   "Palette Area"
  626. There are two palette areas found on the painting window to
  627. select the primary and secondary colors or patterns. These two
  628. selections are accessible by many of the painting tools through
  629. use of either mouse button one or button two, respectively.   See the
  630. specific tool for more information.  All filled objects (i.e. boxes,
  631. ovals, and polygons) are always filled in the secondary color/pattern,
  632. with a border of the primary color/pattern.
  633.  
  634. Colors or patterns may be modified by double-clicking on the icon.
  635. On a colormapped display (i.e. using less than 24-bit colors), changes
  636. to a selected color will change that color in all locations on the
  637. paint canvas as well.  Color selection is done through a color
  638. wheel similar to that used under the "Pattern Editor".  See help on
  639. the "Pattern Editor" for more details as well as for information
  640. on editing patterns.
  641.  
  642. Colors and patterns are loaded from information merged
  643. from the following files each time a canvas is created:
  644. #NL
  645.     .XPaintrc in the user's home directory
  646. #NL
  647.     .XPaintrc in the current directory
  648.  
  649. A quick method for adding a new color is found by using the "Lookup"
  650. button.  This button allows the user to select any color available
  651. on the screen and will either locate it in the current palette or
  652. add it.   Once the color is found in the palette, it is selected.
  653.  
  654. Note:  Color/pattern changes affect both primary and secondary palettes.
  655.  
  656. All of the patterns and colors can be saved with the "Save Palette..."
  657. item in the file menu.
  658. #PUSH
  659. #BEGIN pattern "Pattern Editor"
  660. The pattern editor creates new patterns or modifies existing ones
  661. for use on the painting canvas.
  662.  
  663. The window contains the current pattern and (depending on display
  664. type) the current colormap and a color selection area.
  665.  
  666. Patterns are by default 24x24 in size, but may be set to any size
  667. through the "Size" menu.  The other menus available provide
  668. similar functionality to those in the paint window and pattern
  669. editing uses the normal paint operations.
  670.  
  671. Patterns may be individually saved through the "Save As" option in
  672. the "File" menu or saved with the palette.  See "Save Palette..."
  673. under the Paint Window.  When loading an individual pattern, only
  674. the portion of the pattern which fits in the pattern area will be
  675. included.
  676.  
  677. The "Grab" button allows the user to select a portion of the current
  678. screen to fill the pattern area. 
  679. #PUSH
  680. #BEGIN colormap "Colormap Area"
  681. When using a colormapped display, selecting a colormap entry will
  682. allow the user to change the value of that entry.  This will change
  683. all pixels on the canvas which share this colormap index.
  684.  
  685. The "Lookup" button allows the user to select any color available on
  686. the screen and will locate the colormap entry for this color value.
  687.  
  688. Note:  Manipulating colormap entries effects the canvas immediately
  689. and does not revert when "Cancel" is chosen.
  690.  
  691. #BEGIN colorwheel "Color Wheel"
  692. The XPaint color selection allows access to both the HSV or RGB color
  693. space models.  The color wheel along with the value
  694. slider represents HSV, while the red, green, and blue sliders are for
  695. manipulating the color in an RGB space.  Modifications in either of
  696. these color spaces will effect the other.
  697.  
  698. Colors can be selected on the color wheel by using the mouse to drag
  699. the selection circle or to click on a desired color.   Changes
  700. to value will determine the brightness of the chosen color.  Colors
  701. can also be modified through the red, green, or blue sliders or by
  702. entering values in the text fields.
  703.  
  704. The "Match" button will set the current color by allowing the user to
  705. select any color on the screen.  The exact color will be determined
  706. using the colormap of the selected window.
  707. #POP
  708. #POP
  709. #POP
  710. #BEGIN fileformat    "Image Formats"
  711. XPaint can support a variety of image file formats, based on
  712. library availability at compile time.  Some of these formats may not
  713. be accessible in the current running version.
  714.  
  715. The table below provides a short summary of the features of each image
  716. format and support provided by XPaint.  Note that not all formats are
  717. supported for both read and write operations.
  718.  
  719. Color depth is given in terms of the number of bits used to store the
  720. colors in the image.  This means that a color depth of 1-bit can only
  721. store black/white images, while 24-bit color formats can store images
  722. containing up to 2**24 (or approx. 16 million) colors.  Regardless of
  723. the image format, saved images always reflect the ability of current 
  724. display type (i.e. a color image loaded on a greyscale screen will be 
  725. saved as a grey image).
  726.  
  727. The image mask feature of an image format provides the ability to
  728. save/load odd-shaped regions (i.e. regions are not required to be 
  729. rectangular and may have "holes" in them).   See "Save Region" and 
  730. "Load Clipboard..." for more information.
  731.  
  732. Detailed information about each format is at the end of this section.
  733.  
  734.                         Color        Image
  735. #NL
  736.         Read    Write    depth        mask
  737. #NL
  738. GIF        yes        yes        8-bit            no
  739. #NL
  740. JPEG    yes        no        24-bit        no
  741. #NL
  742. PPM        yes        yes        24-bit        no
  743. #NL
  744. PS        no        yes        24-bit        no
  745. #NL
  746. SGI        yes        yes        24-bit        no
  747. #NL
  748. TIFF        yes        yes        24-bit        yes
  749. #NL
  750. XBM        yes        yes        1-bit            no
  751. #NL
  752. XPM        yes        yes        8-bit            yes
  753. #NL
  754. XWD    yes        yes        24-bit        no
  755.  
  756. GIF - Graphics Interchange Format
  757. #NL
  758.     Popular image format used across a variety
  759. #NL
  760.     of platforms, including PCs.
  761.  
  762. JPEG - JPEG Format
  763. #NL
  764.     A standardized format for storing compressed
  765. #NL
  766.     color and greyscale images.
  767.  
  768. PPM - Portable PixMap Format
  769. #NL
  770.     Image format provided by the PBMplus toolkit
  771. #NL
  772.     which allows for converting to a wide
  773. #NL
  774.     variety of formats.
  775.  
  776. PS - PostScript Format
  777. #NL
  778.     PostScript images are normally used by most
  779. #NL
  780.     printers and text processing packages.
  781.  
  782. SGI - Silicon Graphics Image Format
  783. #NL
  784.     This is a Silicon Graphics (SGI) specific
  785. #NL
  786.     image format, supported by the libraries on
  787. #NL
  788.     SGI machines.  It is not accessible on other
  789. #NL
  790.     platforms.
  791.  
  792. TIFF - Tag Image File Format
  793. #NL
  794.     Default image format used by XPaint.  
  795.  
  796. XBM - X Window BitMap
  797. #NL
  798.     This is a black and white image format which
  799. #NL
  800.     is used by X windows system.
  801.  
  802. XPM - X Window PixMap
  803. #NL
  804.     XPM images are stored in an ASCII text
  805. #NL
  806.     format which can be included in programs.
  807.  
  808. XWD - X Window Dump
  809. #NL
  810.     Used for screen dumps by the X window
  811. #NL
  812.     system.
  813.  
  814. #BEGIN about        "About XPaint"
  815. Hopefully, you find this software useful. If you find any bugs or have
  816. any comments, feel free to contact me.
  817.  
  818. This software is created as DonateWare. If you enjoy using XPaint,
  819. it would be appreciated if you would make a donation to the
  820. author in the form of cookies, money, employment, or whatever.
  821.  
  822. If you or your firm is looking to hire a skilled consultant, contact
  823. me for more details.
  824.  
  825. David Koblas (koblas@netcom.com)
  826. #NL
  827. Extra Mile Consulting
  828. #NL
  829. PO Box 1352
  830. #NL
  831. Mountain View, CA 94042-1352 USA
  832.  
  833. #BEGIN copyright    "Copyright Information"
  834. Copyright (C) 1993, David Koblas
  835.  
  836. Permission to use, copy, modify, and to distribute this software and
  837. its documentation for any purpose is hereby granted without fee,
  838. provided that the above copyright notice appear in all copies and that
  839. both that copyright notice and this permission notice appear in
  840. supporting documentation.  There is no representations about the
  841. suitability of this software for any purpose.  This software is
  842. provided "as is" without express or implied warranty.
  843.